home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 22 / 9 / DISK2295.ZIP / YAMP21.DOC < prev    next >
Text File  |  1989-02-07  |  10KB  |  237 lines
  1. +----------------------------------------------------------------------------+
  2. |                                                                            |
  3. |              Y.A.M.P -- Yet Another Mac Program -- Version 2.1             |
  4. |                Copyright (C) 1988 Galaxy Systems Corporation               |
  5. |                       All Commercial Rights Reserved                       |
  6. |                                                                            |
  7. +----------------------------------------------------------------------------+
  8.  
  9.  
  10.                This program may be freely distributed on a
  11.                noncommercial basis only.  For any business use,
  12.                the program must be licensed from Galaxy Systems 
  13.                Corporation, Box 26387, Richmond, VA  23260-6387.
  14.  
  15.                * NOTICE *  Galaxy Systems Corporation assumes no
  16.                liability for any damages, direct, indirect or   
  17.                consequential, which may arise out of the use of 
  18.                this product or inability to use this product.   
  19.                No warranty, express or implied, including the   
  20.                warranties of merchantibility and fitness for a
  21.                particular purpose, is offered.
  22.  
  23.  
  24. +----------------------------+
  25. |                            |
  26. |  The YAMP ReadMAC Viewer:  |
  27. |  ========================  |
  28. |                            |
  29. +----------------------------+
  30.  
  31. The YAMP program ("Yet Another MAC Program") is a ReadMAC viewer which
  32. has been painstakingly optimized for the display of ReadMACs on CGA
  33. monitors.
  34.  
  35. Also, it has been coded so as to be able to load most any file that
  36. refers to itself as a ReadMAC.  Some ReadMAC viewers are sensitive to
  37. information in the header of the .MAC file and will fail to display
  38. the image properly or at all.  YAMP has been coded for the utmost
  39. flexibility in this regard.
  40.  
  41. Further, the "Smart" half-vertical size mode (see later) has 5 different
  42. contrast settings.  The double-wide mode (see later) is a TRUE double-wide
  43. mode, not just a pixel-duplication double-wide mode.  It is the BEST
  44. double-wide mode I have seen to date.
  45.  
  46. Also, there are no size or panning limitations in the double-wide modes.
  47. The full image is always available.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                   Page 1
  60. Using YAMP:
  61. ===========
  62.  
  63. There are two stages in the use of the YAMP program.  First, you must
  64. select a ReadMAC file to view, and then you select one or more viewing
  65. options.
  66.  
  67. After the YAMP title screen appears and you press a key, the current
  68. directory of *.MAC files is displayed on the screen.  At this point,
  69. you can either give another ambiguous file specification or key in the
  70. name of a file to view.  If you omit the extension, .MAC is assumed.
  71.  
  72.         For example, for a file spec, you could enter
  73.  
  74.                 *.MAC
  75.                 A:\DIR\*.pic
  76.                 d:            (*.MAC assumed)
  77.                 abc\def\*.*
  78.                 \ghi            (*.MAC assumed)
  79.  
  80.  
  81. Once you have selected a file, it will be brought up in "Normal" mode.
  82. In this mode, the image will appear elongated, because of the difference
  83. in the aspect ratios between the IBM CGA display and the Apple Macintosh
  84. display.
  85.  
  86. And while viewing a file, F1 or F8 bring up a help menu.  F1 was the
  87. original key used by YAMP; F8 was added to be consistent with the
  88. REPP310 Printer Art Conversion Package, in which the YAMP viewer is
  89. also included.
  90.  
  91. Once you are viewing a file, a number of display-modificaton options
  92. become available.  Most are selected with single keystrokes.  If an
  93. option is selected with a letter, both upper and lower-case versions
  94. of the letter will work identically.
  95.  
  96. The options are as follows:
  97.  
  98.     .  You can scroll the image with the Arrow Keys and PgUp and PgDn.
  99.  
  100.     .  The Home key brings you to the top of the image, and the
  101.        End key puts you at the bottom of the image.
  102.  
  103.     .  Ctrl-Left Arrow aligns you with the left edge of the image, and
  104.        Ctrl-Right Arrow aligns you with the right edge of the image
  105.        (especially useful in the double-wide modes).
  106.  
  107.     .  "V" toggles between 1/2-vertical & normal modes.  Because of the
  108.        number of vertical scan lines on the CGA display (200) as opposed
  109.        to the number of lines on the Macintosh (350 or so), the image on
  110.        the CGA will appear elongated.  Cutting the image in half restores
  111.        the aspect ratio but loses you some detail.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                   Page 2
  119.     .  "H" toggles between enhanced-dbl-wide & normal modes.  Another way
  120.        to get around the elongation problem is to make the ReadMAC image
  121.        twice as wide on the CGA screen.  This means you will now have to
  122.        scroll sideways to view the entire image, but you will not lose
  123.        any detail.  However, the image may appear grainy.  This enhanced
  124.        double-wide mode has been set up to reduce the graininess where
  125.        possible.  See also the next option.
  126.  
  127.     .  "T" toggles between original-dbl-wide & normal modes.  "T" is the
  128.        original way in which most ReadMAC viewers created a double-wide
  129.        mode.  It is still useful with the UTIL Menu colorization options
  130.        of the REPP310 package and so has been included here.
  131.  
  132.     .  "S" begins a sequence of 1/2-vertical "Smart" modes.  Keying "S"
  133.        again & again toggles between 5 contrast settings.  These modes
  134.        are similar to the "V" mode but use extra algorithms to enhance
  135.        the image.  You get out of the "S"mart modes by choosing another
  136.        mode, such as "H", "V", "P" (see below), or "N" (for normal mode).
  137.  
  138.     .  "P" begins a sequence of 1/2-vertical Palette-1 colorizations.
  139.        Pressing "P" again & again toggles between 5 contrast settings.
  140.        "P" modes function like the "S" modes above.  Again, get out the
  141.        "P" modes by choosing another mode (H,V,N,S).
  142.  
  143.     .  "I" simply inverts the image top-to-bottom.
  144.  
  145.     .  "M" mirrors the image.  (Inverts left-to-right.)
  146.  
  147.     .  "L" toggles between Landscape and Portrait views of the image.
  148.        The Portrait (or vertical) view is the normal view.  The Landscape
  149.        (or horizontal) view is created by this option the first time
  150.        this option is selected for a particular image.  Thereafter, access
  151.        to the Landscape view of an image is practically instantaneous.
  152.        Note that the Portrait and Landscape views of an image are
  153.        independent images.  That means you can manipulate one image
  154.        without affecting the other, and when you toggle between the
  155.        images, you will always return to where you left off with an
  156.        image, and return to the display mode in which you were with
  157.        that image.
  158.  
  159.     .  "D" just reDisplays the current screen.  This is useful after the
  160.        display of the help screen.
  161.  
  162.     .  "Z" applies a smoothing algorithm to the image.  Sometimes, after
  163.        the creation of a Landscape version of a ReadMAC, a "striping"
  164.        or "lined-up" effect will appear.  Smoothing will get rid of this,
  165.        but we suggest trying the "S"mart modes on the image first.
  166.        This is because the "Z" function actually changes the image
  167.        in memory, and if you have both Portrait and Landscape views,
  168.        it changes them BOTH.  There are some exiguous technical reasons
  169.        for this, which we will omit here.  See also the next option.
  170.  
  171.        Extra note:  The smoothing routine (Z) turns out to be asymmetric
  172.        in its effect on the "S"mart and "P"alette modes.  This means that
  173.        after "smoothing" or colorizing, the "S"mart and "P"alette modes may
  174.        differ in their effect on an image that has been mirrored from one
  175.        that has not been mirrored.  Try it and see.
  176.  
  177.                                   Page 3
  178.     .  "R" reloads the image from disk.  If, after a smoothing function
  179.        (the only function that actually modifies the image), you decide
  180.        you would like the original image back, just press "R".  If you
  181.        are using YAMP from within the REPP310 package, this keeps
  182.        you from having to return to the REPP or UTIL menu screen to
  183.        request a reload of the ReadMAC file.
  184.  
  185.     .  RETURN (ENTER) or ESC get you out of YAMP and return you to the
  186.        files display.
  187.  
  188.     .  "Ins" and "Del" are the "BOSS" keys for the YAMP viewer.  They
  189.        are active only while you are viewing an image.  If you press
  190.        these keys, they will show a normal screen on an apparently
  191.        "hung" system.  No keystrokes will appear to work (besides Ctrl-
  192.        Alt-Del, of course).  "See boss, the machine appears to be
  193.        hung.  I press keys and nothing happens!"  To get out of the
  194.        BOSS screens (there are two available) either press Ctrl-Home
  195.        or (if your Boss is watching) re-boot with Ctrl-Alt-Del.
  196.  
  197.        If your Boss comes around WHILE you are VIEWING THE FILE 
  198.        DIRECTORY, just press RETURN twice.
  199.  
  200.  
  201.  
  202. A note on REPP310:
  203. ==================
  204.  
  205. YAMP is included within the REPP310 Printer Art Conversion Package.
  206. This package is available from PC-SIG on their Printer Art disk #154.
  207.  
  208. This package is able to convert old-style printer art text files into
  209. displayable graphics.  The package has a number of options and
  210. capabilities, including the ability to be used as a general text-file
  211. scrubber.  For some reason, using REPP to play around with the old
  212. text file pictures is kind of fun, and the disk is very popular.
  213.  
  214. NOTE:  The REPP310 version of the PC-SIG Printer Art disk is expected
  215. to be available March 15, 1989.  The current version of REPP, REPP288,
  216. does not have YAMP incorporated.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.                           --- End of Document ---
  233.  
  234.  
  235.  
  236.                                   Page 4
  237.